home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 12 / Cream of the Crop 12 (Part II) / Cream of the Crop 12 (Part II).iso / BBS / GBOWL10.ZIP / GUTBOWL.DOC < prev    next >
Encoding:
Text File  |  1996-04-30  |  26.2 KB  |  518 lines

  1.  
  2.  
  3.                         GuTTeRBoWL Version 1.0  May 1996
  4.                Program & Design by Robert Kidwell & Charlie Wardick
  5.              KIDware Software (c) Copyright  1996 All Rights Reserved
  6.  
  7.                                    DISCLAIMER
  8.         ====================================================================
  9.         The authors have  taken  every  precaution to  insure  that  no  harm
  10.         or damage will occur on  computer systems  operating  this  package.
  11.         Nevertheless,  the  author  shall  NOT be held liable  for  whatever
  12.         may happen  on your  computer system  or  to  any  computer  systems
  13.         which connects to your own as a result of  operating  this  package.
  14.         The  user  assumes  full responsibility for the correct operation of
  15.         this software package,  whether harm or damage results from software
  16.         error, hardware malfunction, or  operator  error.  NO warranties are
  17.         offered, expressly stated or implied,  including without  limitation
  18.         or restriction any warranties of  operation for a particular purpose
  19.         and or merchantability.   If you do  not agree with this then do NOT
  20.         use this program.
  21.  
  22.                                 LICENSE AGREEMENT
  23.         ====================================================================
  24.         GuTTeRBoWL(c) is copyrighted by Robert Kidwell and KIDware software
  25.         and retains full rights to said software.  GuTTeRBoWL is Shareware.
  26.  
  27.         The Shareware concept is simple.  Try before you Buy.
  28.  
  29.         We hope you will register soon after you install the game on your
  30.         system.  The registered features are well worth the effort.
  31.  
  32.         KIDWARE Software  permits  this  software  to be carried on Bulletin
  33.         Board Systems (BBS), Internet sites, and CD media for distributing
  34.         this archive.
  35.  
  36.         The  archive  must include ALL files listed in the archive contents.
  37.         The archive name, filedate, and internal file descriptions may not
  38.         be changed.
  39.  
  40.         GuTTeRBoWL cannot be altered to reflect exchange of ownership.
  41.         GuTTeRBoWL cannot be transferred or re-sold.  Doing so will void
  42.         the Licensing Agreement.
  43.  
  44.         If a Licensed Keyholder looses their keyfile info.   A  new key may be
  45.         issued to the Licensed Keyholder if the Licensed Keyholder can provide
  46.         valid Proof of Purchase to the author via Postal mail.
  47.         The cost of a key replacement is $5.00   The Keyholder must call the
  48.         authors BBS to pick up the replacement keyfile.
  49.  
  50.         Definition: Valid Proof of Purchase  - A photo copy of the printed
  51.         receipt mailed to each registered user of GuTTeRBoWL from the author.
  52.  
  53.  
  54.                                  INTRODUCTION:
  55.         ====================================================================
  56.         GuTTeRBoWL    is  designed  to  be  the greatest Online effort of as
  57.         true to life bowling as the  real  thing.   With  the  user in total
  58.         control of ball curve action for realistic rolls to hit  those sweet
  59.         spots in the lane.  GuTTeRBoWL's  design  was taken from the orginal
  60.         source code of  BBSBowl  by  J.Fair.     We have taken the game to a
  61.         higher level with  support for V34 modems and automatic multitasking
  62.         timeslices  given.  Now  supports  more  dropfiles than ever before.
  63.         GuTTeRBoWL  has been tested on all known operating systems and works
  64.         on all known modem speeds including ISDN.
  65.  
  66.  
  67.                         WHY YOU SHOULD REGISTER THIS GAME?
  68.         ===================================================================
  69.         GuTTeRBoWL is Shareware, which is an innovative approach to selling
  70.         Quality software at a reasonable cost.   You simply try, before you
  71.         buy the software.
  72.  
  73.         GuTeRBoWL is fully functional in it's present state, but some added
  74.         features requires registering to make them definable.
  75.  
  76.         Why would you register GuTTeRBoWL?
  77.  
  78.        *  It's the BEST Bowling game EVER for Online use.
  79.        *  More than 13 player can play.   REGISTERED Max of 100
  80.        *  Player can use MAKEUP days. If the player skips a day. It can be
  81.           played at a later date thru the MakeUp option.
  82.        *  Remove that tacky UNregister BBS and replace with YOUR BBS name.
  83.        *  Allow a user to donate and be recognized in the closing credits.
  84.        *  Allow more than one game play per day.  Unregistered only allows
  85.           one game per day.  Not cool..
  86.        *  Allow the sysop to configure COMMENTS off when game starts.
  87.        *  A one time registration fee.
  88.        *  A warm fuzzy feeling that you're helping to support the Programmers
  89.           to continue to support and add to the game.
  90.  
  91.               See REGISTER.DOC on how to register this super game.
  92.  
  93.                                 REQUIREMENTS:
  94.         ===================================================================
  95.         At this point in  time the only requirements are FILES=30 (or more)
  96.         in your  config.sys file and ANSI.SYS. SHARE must also be loaded IF
  97.         you  intend  to  use the  game in a multi-node environment OR under
  98.         DesqView. The game is RIP  aware but NOT a RIP Game at this time. A
  99.         FOSSIL  is  NOT  required  to  run  the game,  although one will be
  100.         supported if it exists.  Automatic time slicing support is provided
  101.         to most common multi-taskers as well.
  102.  
  103.         DESQView users should have DVANSI loaded prior running this door.
  104.  
  105.         GuTTeRBoWL may appear at times to be choppy, this is the game giving
  106.         timeslices to the CPU.   If your CPU isn't fast enough, with a multi-
  107.         line  system  this  effect  will be more pronounced.  This cannot be
  108.         avoided due to the animation action of the game.
  109.  
  110.         GuTTeRBoWL is an ANSI animated intensive game.  GuTTeRBoWL is an ANSI
  111.         ONLY Doorgame and should NOT be played by non-ANSI players.
  112.         Baud rates below 2400 will feel somewhat sluggish during screen
  113.         redraws.
  114.  
  115.         GuTTeRBoWL has built in ansi detect and should turn away non-ansi
  116.         players.
  117.  
  118.         GuTTeRBoWL may require DOS SHARE to be loaded for multi-line
  119.         operation.
  120.  
  121.                                 FILES INCLUDED:
  122.         ====================================================================
  123.         Below  is  a listing of all files for the  this  Game.   If you are
  124.         missing ANY of these files, the archive may have been altered.
  125.  
  126.         Files marked (*) are not needed for GuTTeRBoWL to work properly.
  127.  
  128.  
  129.         GUTBOWL.EXE   - Main executable
  130.      *  GBWLAD.ANS    - A announcement ad for this version you may post.
  131.                         (not needed for GB to run)
  132.  
  133.      *  SAMPLE.CTL    - A DDPLUS sample control file showing some available
  134.                         control options.   You may edit it and rename it to
  135.                         Gutter.ctl    This file is created with  Gutcfg.exe
  136.      *  GUTBOWL.DOC   - This document giving details of the game.
  137.  
  138.         GUTCFG.EXE    - A neat setup program to create the Gutter.ctl file
  139.                         written by Chas Wardick and Robert Kidwell.
  140.                         Totally sets up GuTTeRBoWL without DOCs!
  141.  
  142.      *  BALL-DE.LAY   - This is a control file that sets the delay on ball
  143.                         rotation curve,  and  speed the ball rolls at.  If
  144.                         missing the game uses it's internal settings.
  145.                         You may rename to compare performance before removing
  146.                         this file.
  147.  
  148.      *  QUICKST.ART     A down and dirty DOCs to get you running super fast.
  149.  
  150.         ===================================================================
  151.         Files created by GuTTeRBoWL upon first playing initialization:
  152.         ===================================================================
  153.  
  154.         PLAYER.DAT    - Created when the first player enters the game.
  155.                         If data becomes corrupt, simply delete this file and
  156.                         a new one is created.
  157.         GUTTER.MSG    - Built in Oneliner Data file  This file uses the
  158.                         L.O.R.D. type coloring scheme. This file is created
  159.                         when the first player enters the Bowlers Bater.
  160.  
  161.         CENSOR.DAT    - Another Onliner created file that can be edited to
  162.                         include those NASTY words you want to filter.
  163.                         This file will be created when the first player post
  164.                         a line of wit in the Bowlers Banter.
  165.  
  166.                         CAUTION: This file contains obscene words.  These
  167.                         words are not to offend.  These words are to protect
  168.                         your system from those using them.  This file may be
  169.                         edited to include your own colorful metaphors.
  170.  
  171.         GUTWIN.DAT    - Created at the end of each month showing winners of
  172.                         each catagory of stats
  173.  
  174.         GUTTER.CTL    - This file is created thru GUTCFG.EXE which holds vital
  175.                         information on how the game reacts. (needed file)
  176.  
  177.         GUTTER#.CTL   - Same as above but created with node# to be used with
  178.                         the /M# option.
  179.  
  180.         ==================================================================
  181.                          COMMANDLINE GAME SWITCHES
  182.         ==================================================================
  183.         Some of the below switches are redundant because GUTCFG.EXE sets
  184.         these functions in the GUTTER.CTL file.
  185.         ===================================================================
  186.         Switches marked (*) can be set with GUTCFG.EXE upon your first
  187.         installation and can edited thru GUTCFG at a later date.
  188.         
  189.         These are commandline switches that may be used that override some of
  190.         the CTL file settings.
  191.  
  192.      *  "/Bxxxxx"   This tells GAME.EXE to lock its baud rate at
  193.         xxxxx.  In order to get the most efficiency out of a high speed
  194.         error correcting modem (9600 baud or above), you may lock the baud
  195.         rate to a speed higher than what the caller is actually using.
  196.         By locking the baud to say 38,400, the modem can compress text data
  197.         that is being sent and achieve a baud rate much higher than the
  198.         actual transmission rate.
  199.         This will lock the baud rate at the same value for all nodes that
  200.         use this command line.  If you perfer a more selective way to lock
  201.         baud use 'LOCKBAUD' command in the GAME.CTL file.
  202.  
  203.      *  "/Cx"     (where x is 1..4) This specifies a comport number.
  204.         Some bbs software does not create door information files (dropfiles)
  205.         that contain the comport number.  If your bbs does have a comport
  206.         listed in the dropfile then there is no need for this parameter.
  207.         The default is comport 0, local mode.
  208.  
  209.         If you are using non standard IRQs try creating them with DDSETUP
  210.         and the settings will be placed in the control file for you.
  211.  
  212.         "/E" - Expanded Memory Specification If your machine has over one
  213.         megabyte of memory, then you may have some available.  GAME.EXE can
  214.         utilize EMS to improve game performance and reduce conventional
  215.         memory requirements.
  216.         This command will tell GAME.EXE   to use EMS memory to hold its
  217.         overlay buffer.  Otherwise disc area may be used to hold this buffer.
  218.         This needs a memory manager and when enabled and is compatible with
  219.         DESQview. Default is NOT to use available EMS.
  220.  
  221.  
  222.  
  223.         "/L"      This tells GAME.EXE to load up in LOCAL mode.
  224.         This is good for testing or when a sysop just wants to "try out" the
  225.         door without messing with his BBS setup.  The "/L" mode will ask the
  226.         user for his name and run the door in local mode.
  227.  
  228.         Use this to test your door to see if things are working properly.
  229.  
  230.         "/Nx"     (where x is 1..9) This specifies a "node number".
  231.         Some bbs software support multinode environments in which you must
  232.         know the node number of the drop file to use. For example, RBBS-PC
  233.         uses DORINFOx.DEF. If you specified "/N2" then GUTBOWL.EXE would use
  234.         DORINFO2.DEF.
  235.  
  236.         Author's Note:  For multi-line systems use this switch to recognize
  237.                         multi-Gutter#.ctl files
  238.                         Example:
  239.                         /M1 = GUTTER1.CTL  for node1
  240.                         /M2 = GUTTER2.CTL  for node2
  241.                         /M10= GUTTER10.CTL for node10
  242.  
  243.         "/Mx"     (where x is up to 2 filename acceptable characters)
  244.         Used to specify one of Multiple control files.  If you have created
  245.         more than one GAME.CTL file (GAME1.CTL, GAME2.CTL, etc.) for each
  246.         node or network PC then you can select the one you want by using
  247.         the /M parm.
  248.         Example:  "/M2" will force GAME.EXE to use GAME2.ctl.
  249.  
  250.         "/Pyyy"   This specifies the path to the drop files.
  251.         For example, "/PC:\WILDCAT\WCWORK\NODE1" would tell GAME.EXE to
  252.         look for the drop file in C:\WILDCAT\WCWORK\NODE1. If this is left
  253.         out the program assumes the drop file is local.
  254.  
  255.         GUTBOWL /Pc:\ra\node1
  256.         Would look to node1 for the dropfile
  257.         GUTBOWL /Pc:\ra\node2
  258.         Would force the game to look in node2 for the dropfile
  259.  
  260.         "/R" To force local RIP for the sysop. Used only if the program
  261.         has RipLink built in and the door supports RIP.  Use AFTER the
  262.  
  263.         "/L" parameter if you are using the door in local mode.
  264.         
  265.         "/V"    This command will tell GAME.EXE not to show any display
  266.         on the local screen.  Only a colored screen and a message will be
  267.         displayed.  The cursor will not move as it will be turned off.
  268.         Saves a little processing on multi-tasking systems.
  269.  
  270.         "/W"      This flags the program that a network is present even
  271.         though no multitaskers are detected.  This is useful if the door is
  272.         run on a network such as Novell that doesn't use multitaskers.
  273.  
  274.         For those that have complicated setups, take a look at the SAMPLE.CTL
  275.         file to ALL DDPLUS door switch options.
  276.  
  277.         Example: GUTBOWL /M1 /PC:\RA\NODE1
  278.  
  279.                  This would startup GuTTeRBoWL using GUTTER1.CTL and look
  280.                  at C:\RA\NODE1 for it's dropfile
  281.  
  282.                  My GUT2.BAT to start it up would be.
  283.  
  284.        Example:  GUTBOWL /M2 /PC:\RA\NODE2
  285.  
  286.                  This would startup GuTTeRBoWL using GUTTER2.CTL and look
  287.                  at C:\RA\NODE2 for it's dropfile.
  288.  
  289.                  Sample batchfile:
  290.  
  291.                  cd\ra\doors\gutter
  292.                  gutbowl /m2 /pc:\ra\node2
  293.                  cd\ra
  294.  
  295.                  Be sure to use GUTCFG.EXE to create all your nodes CTL's
  296.                          IT'S SOOOO EASY THIS WAY!!!!!!!
  297.         ===================================================================
  298.                      Setting up your GUTTER.CTL file
  299.         ===================================================================
  300.         Run the inclosed program called GUTCFG.EXE which will create the
  301.         GUTTER.CTL for you and allow you to select CTL options.
  302.  
  303.         If you run multi-node and have different comports for each node. You
  304.         will need to create a seperate GUTTER#.CTL for each node. GuTTeRBoWL
  305.         will recognize each differnt *.CTL when it's started up with the /M#
  306.         switch.  Example:  GUTBOWL /M2 /PC:\RA\NODE2
  307.         This shows using the /M# switch to recognize GUTTER2.CTL and the /P
  308.         switch locates the path the node2 dropfile.  Simple!
  309.  
  310.         If you have ONLY one node you may run the commandline in your batchfile
  311.         as such.  Example: GUTBOWL /PC:\PATH\TO_DROPFILE
  312.  
  313.         By using GUTCFG.EXE one could have more than one CTL file for the same
  314.         node thus allowing the game to react differently in two CTL setups.
  315.  
  316.         GUTTER1.CTL GUTTER2.CTL GUTTER3.CTL and so forth must be in the
  317.         game directory.
  318.  
  319.         Here's the slick part of GUTCFG.EXE.
  320.  
  321.         If you have more than one GUTTER#.CTL files, you can update them all
  322.         almost instantly when entering your registration information.
  323.         
  324.         If you are running GUTCFG.EXE from a new DESQView window, be sure to
  325.         load DVANSI before running GUTCFG for proper display.
  326.  
  327.         ===================================================================
  328.                                 COMMON ERRORS
  329.         ===================================================================
  330.             003  File path not found. Check to make sure the game
  331.                  directory is correctly named as GAMEDIR.
  332.             201  Files not found. Check to make sure that all required
  333.                  games files are in the GAMEDIR directory.
  334.  
  335.         Install the door into your BBS software (see your BBS
  336.         software documentation for more information).  A batch file is
  337.         normally used to do this.  To run the program just have your
  338.         batch file change to the GAMEDIR directory and run GAME.EXE -
  339.         Thats all there is to it!  Three different batch files sample
  340.         are included to help you run the game. These are included with
  341.         the game for editing and your use. Remember when writing the
  342.         batch routines for my games you must ensure that the game is
  343.         run from it's home directory AND that the game knows where to
  344.         find the drop file.  Satisfy these two requirements and you
  345.         should have no problems running the game as long as the other
  346.         setup criteria has been met. For dorinfo systems try using the
  347.         following:
  348.  
  349.  
  350.                                  Multinode use
  351.                                   -------------
  352.         This game supports multinode use and provides automatic
  353.         multi-tasker support  (time slice releasing) for a wide variety
  354.         of multi-taskers.
  355.  
  356.                Common Problems (Locked Bauds, High Speed modems, etc)
  357.                ------------------------------------------------------
  358.  
  359.         1.   The game does NOT require a fossil driver to run.
  360.  
  361.         2.   If you are running a high speed modem (9600 baud or above),
  362.              then I suggest you run your bbs/mailer/doors at a locked baud
  363.              rate. On high speed error correcting modems, locking the baud
  364.              rate will have a noticeable increase on the speed of text that
  365.              is sent. It's beyond the scope of this document to discuss
  366.              configuring your BBS and mailer for a locked baud rate; you may
  367.              wish to consult those docs for information on that. Here are a
  368.              few things to keep in mind when setting up GAME with a locked
  369.              baud rate:
  370.  
  371.              a.  When using a locked baud rate, I highly recommend
  372.                  using a  FOSSIL driver. This game will work at high
  373.                  speeds without one though. BNU is a good fossil driver
  374.                  which can even be loaded and unloaded before and after
  375.                  you run this game.
  376.  
  377.              b.  If you are using a fossil, then make sure to tell the
  378.                  fossil that the port is locked. For BNU, to lock com1:
  379.                  at 38,400, you would use something like "L0=38400" on
  380.                  BNU's command line.
  381.  
  382.              c.  If you lock the baud for one program, it must be
  383.                  locked for everything. You can't lock the baud for just
  384.                  this game, but not your BBS/mailer.
  385.  
  386.              d.  You may need to use the /B switch on the game.exe
  387.                  Command line to specify the locked baud rate. For
  388.                  19,200 this would be "/B19200" and for 38,400 this
  389.                  would be "/B38400". Please note there is no space
  390.                  between the "/B" and the baud rate.
  391.              e.  For IRQ settings can be setup with DDSETUP program.
  392.  
  393.         3.   What follows is some information on possible strange
  394.              situations that may occur:
  395.  
  396.              a.  Low speed users can play the game, but high speed
  397.                  users get garbage.
  398.      
  399.                  - If you are not using the DORINFOx.DEF or
  400.                    DOOR.SYS drop file then you may wish to find a
  401.                    converter program to convert whatever drop file
  402.                    your BBS produces to the DORINFOx.DEF or DOOR.SYS
  403.                    format and tell game.exe to use that.
  404.  
  405.                    Several converter programs are readily available
  406.                    on most BBS systems. CallDoor is a good one if you
  407.                    can find it. I have it on my BBS for download if
  408.                    you need it.
  409.  
  410.              b.  The game hangs up when a user enters the game.
  411.  
  412.                  - Sounds like the game is getting the wrong baud
  413.                    rate somehow. Try switching over to the DOOR.SYS
  414.                    drop file method if possible.
  415.  
  416.              c.  Text and screens are getting cut off.
  417.  
  418.                  - If you are running with a locked baud, then this
  419.                    could be caused by some sort of FLOW CONTROL
  420.                    problem. Try using a fossil if you aren't already.
  421.  
  422.              d.  If you're using something other than the DOOR.SYS
  423.                  drop file, then I always suggest trying to use
  424.                  DOOR.SYS if possible. It is the most reliable method
  425.                  and has had the most testing. If that is not possible
  426.                  try DORINFOx.DEF as an alternative.
  427.  
  428.              e.  A door locks up node 1.  This can happen with fossils
  429.                  or the internal communications routines because it
  430.                  uses the default comport of 1 when NONE is found in
  431.                  the dropfile or game.ctl file. To correct this make
  432.                  sure the right port is shown in the dropfile OR
  433.                  game.ctl file.
  434.  
  435.              f.  ANSI is reflected correctly on the local screen but
  436.                  the user is getting garbage.  Assuming the user has
  437.                  ANSI installed then most likely the problem is at
  438.                  your end. First make sure you have configured the 
  439.                  game.ctl file to show the correct locked port rate.
  440.                  Second make sure the dropfile is passing the locked
  441.                  port rate INSTEAD of the actual connect rate.  If it
  442.                  is not passing the locked port rate then you may
  443.                  need to use a different dropfile format OR use a
  444.                  dropfile converter program to change the line to
  445.                  show the locked port rate INSTEAD of the actual
  446.                  connect rate.
  447.  
  448.                             "Corrupted" data files
  449.                              ----------------------
  450.         It is possible that something could happen to your game
  451.         data file.  A power outage, game crash, or other event could
  452.         damage the data  files.
  453.  
  454.         If the Player info looked screwed up, delete the player.dat
  455.         file and the game will create another one.
  456.  
  457.                     
  458.                                  CREDITS:
  459.                                  --------
  460.         This relatively small section is just to recognize the
  461.         GOOD people  who have made this door a possibility.
  462.  
  463.         *-----------------------------------------------------------------*
  464.                       GuTTeRBoWL Beta Team Members
  465.         *-----------------------------------------------------------------*
  466.         Name               Fidonet#    BBSname & number   Modem Speeds & #
  467.         -------------------------------------------------------------------
  468.         Charlie Wardick   @1:234/68    Never Surrender    V34+(419)475-8705
  469.         ===================================================================
  470.         Kitt Brown        @1:133/3003  KABOODLE           V34+(706)602-9085
  471.         Mark Bloss        @1:116/180   A Spyer            V32b(615)831-9284
  472.         Charles Dobbs     @1:116/6     Police Station     V34+(615)226-7841
  473.         John Meeks        @1:116/694   Nashville Windows  V34+(615)832-1874
  474.         Della Moore       @1:14/787    Moore Fun          V34+(316)221-2408
  475.         Tom Smith         @1:109/630   Gray Hawks Lair    V34+(703)751-2729
  476.         Tom Wall          @1:116/209   The Law and Order  V34+(615)441-3302
  477.         Jeff Watkins      @1:234/60    YES Another BBS    V34+(419)389-6568
  478.         ===================================================================
  479.         Robert Kidwell    @1:116/52    The Borg           V34+(615)368-7003
  480.  
  481.         *-----------------------------------------------------------------*
  482.                              The DDPlus Team
  483.         *-----------------------------------------------------------------*
  484.          Thanks to Scott Baker, Steve Lorenz, Bob Dalton, Andy Stewart
  485.          Tom Morgan and other contributors for that great turbo pascal
  486.          door kit.  If you ever want to make a door product for use with
  487.          BBS's then this is the kit to get!
  488.         
  489.         L.O.R.D. is (c) of Robinson Technologies
  490.  
  491.         DESQview is a registered trademark of Quarterdeck Office Systems.
  492.         Doordriver kit is proprietary software by Scott Baker.
  493.         Ripscript & Ripterm are registered trademarks of TeleGrafix
  494.         Communications.
  495.  
  496.         Turbo Pascal 7 (r) of Borland International Inc.
  497.  
  498.         Thanks Chas for putting up with me over the last nine months over
  499.         this project. We've struggled with this.  For a couple of rookies
  500.         "WE DID GOOD!"  Thanks PAL!
  501.  
  502.         My hats off to those names mentioned in the Beta team list.  Without
  503.         them, this game would just be another game.  Thanks Ladies and Dudes.
  504.  
  505.         Thanks Della for editing my third grade grammer.
  506.  
  507.                                Where to reach me
  508.                           =================================
  509.                           KIDWARE Software
  510.                           c/o Robert Kidwell
  511.                           6427 Arno College Grove Rd
  512.                           College Grove,Tennessee 37046-9130
  513.                           USA
  514.  
  515.                           FidoNet 1:116/52  @speeds to 33,600
  516.                           BBS name: The Borg (615)368-7003
  517.  
  518.